<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3c.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
  <title>Building Ibator from Source</title>
  <link type="text/css" rel="stylesheet" href="../ibator.css"/>
</head>
<body>

<div class="menuNav">
  <p>
    <a href="../index.html" target="_top">Show Menu</a>
    <a href="building.html" target="_top">Hide Menu</a>
  </p>
</div>

<h1>Building Ibator from Source</h1>
<p>All Ibator distributions include source code.  The only compile time dependency Ibator
has is on <code>ant.jar</code> - for successful compilation of the included Ant task.
It is straight forward to compile Ibator from source - simply unzip the source in
an Ibator distribution and compile it with your favorite tool.</p>
<p>The Ibator distribution does not contain the tests that are run during the build,
or other classes that are a necessary part of the build.  If you would like to
inspect those classes, or build Ibator from the very latest version of the source code
at Apache then follow these steps:</p>
<ol>
  <li>Ibator is built with Apache Maven2.  First you must get maven
      running.  If you are new to Maven, here are the most simple steps (for Windows):</li>
      <ol type="a">
        <li>Download a Maven distribution from <a target="_blank" href="http://maven.apache.org/">
          http://maven.apache.org/</a></li>
        <li>Unzip the distribution somewhere convenient</li>
        <li>Setup environment variables and the PATH.  Examples:<br/>
            set JAVA_HOME=C:\JavaTools\jdk1.6.0_17<br/>
            set M2_HOME=C:\JavaTools\apache-maven-2.2.1<br/>
            set PATH=%PATH%;%M2_HOME%\bin;
        </li>
      </ol>
  <li>Do a Subversion checkout of the Ibator source tree from the location
    <a target="_blank" href="http://svn.apache.org/repos/asf/ibatis/java/ibator/trunk/core/">
    http://svn.apache.org/repos/asf/ibatis/java/ibator/trunk/core/</a>
    (You may use any Subversion client you prefer.  We recommend
    <a target="_blank" href="http://tortoisesvn.tigris.org/">TortoiseSVN</a>.)
  </li>
  <li>Open a command window in the directory where you checked out the Ibator source and
      run the command <code>mvn clean install</code> - or any of the other Maven lifecycle commands.
      You can use the <code>mvn site</code> command to generate the code coverage reports, but the
      Ibator website is not built with Maven at this time.
  </li>
</ol>


</body>
</html>
